<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8" />
<link rel="stylesheet" type="text/css" href="./styles_main.css" />
<title>Yet Another Snippet extension 日本語訳</title>
</head><body>

<ul class="primary-links">
  <li><a href="./index.html">Intro and tutorial</a></li>
  <li><a href="./snippet-organization.html">Howto: organize</a></li>
  <li><a href="./snippet-expansion.html">Howto: expand</a></li>
  <li><a href="./snippet-development.html">Howto: write</a></li>
  <li><a href="./snippet-menu.html">Howto: menu</a></li>
  <li><a href="./faq.html">FAQ</a></li>
  <li><a href="http://yasnippet.googlecode.com/svn/trunk/doc/changelog.html">ChangeLog</a></li>
  <li><a href="http://code.google.com/p/yasnippet/downloads/list">Download</a></li>
</ul>

<p class="original">原文： <a href="http://yasnippet.googlecode.com/svn/trunk/doc/index.html">http://yasnippet.googlecode.com/svn/trunk/doc/index.html</a>
<span class="translated-date">(translated on 2010/Dec/21)</span>
<a class="link-to-editors-room" href="http://code.google.com/p/yasnippet-doc-jp/">⇒ 翻訳プロジェクト</a>
</p>

<h1>Yet Another Snippet extension</h1>

<p class="notice"><strong>〔重要〕</strong> このドキュメントは YASnippet の <strong>SVN trunk</strong> に対して適用されるものです。
SVN trunk は<a href="http://code.google.com/p/yasnippet/source/checkout">こちら</a>から取得できます。
他のバージョンに対するドキュメントは<a href="http://code.google.com/p/yasnippet/downloads/list">こちら</a>で見られます。
</p>

<ul class="toc">
  <li><a href="#video-demo">Video Demo</a></li>
  <li>
    <a href="#installation">Installation</a>
    <ul>
      <li><a href="#install-with-yasnippet-bundle-el">Install with <code>yasnippet-bundle.el</code></a></li>
      <li><a href="#normal-install">Normal Install</a></li>
    </ul>
  </li>
  <li><a href="#how-to-use-yasnippet">How to use YASnippet</a></li>
  <li><a href="#bugs-contribution-and-support">Bugs, Contribution and Support</a></li>
</ul>

<div class="contents">

<p><strong>YASnippet</strong> は、Emacs のためのテンプレートシステムです。
省略形でタイプすると、自動的に関数テンプレートに展開してくれます。
次の言語向けのテンプレートが同梱されています： C, C++, C#, Perl, Python, Ruby, SQL, LaTeX, HTML, CSS, ...
</p>

<p>スニペットの構文は TextMate の構文にインスパイアされたものです。
そのため、TextMate テンプレートを<a href="./snippet-development.html#importing-textmate-snippets">取り込む</a>こともできます。
YASnippet は <a href="http://code.google.com/p/smart-snippet/">smart-snippet</a> という拡張機能を書き直したものです。
これらは両方とも <a href="http://pluskid.lifegoo.org/">pluskid</a> のオリジナルな作品です。
</p>

<h2 id="video-demo">Video Demo</h2>

<p><a href="http://www.youtube.com/watch?v=76Ygeg9miao">YouTube にあるデモ</a>をご覧ください
（高解像度版： <a href="http://yasnippet.googlecode.com/files/yasnippet.avi">yasnippet.avi</a>）
</p>

<h2 id="installation">インストール</h2>

<p>ダウンロード可能なアーカイブは２種類あります。
YASnippet をちょっと試してみるには、よりシンプルな &quot;bundle&quot; バージョンをダウンロードしてください。
もし同梱されているテンプレートを改造したり、自作したりするつもりがあるなら、&quot;normal&quot; バージョンをダウンロードしてください。
</p>

<h3 id="install-with-yasnippet-bundle-el"><code>yasnippet-bundle.el</code> のインストール</h3>

<ol>
  <li><p>最新の <code>yasnippet-bundle-x.y.z.el.tgz</code> をダウンロードして、それを展開（解凍）してください。</p></li>
  <li><p><code>yasnippet-bundle.el</code> という名前のファイルができるはずなので、それを <code>~/.emacs.d/plugins/</code> の下に置いてください（このディレクトリが無かったら作ってください）。</p></li>
  <li><p>そのファイルを Emacs で開いて、<code>M-x eval-buffer</code> を入力してください。</p></li>
</ol>

<p>これでおしまいです。
この状態でプログラミング言語のソースファイルを開くと、YASnippet メニューが現れます。
テンプレートを挿入するには、メニューから選択するか、
もしくは、<em>trigger key</em> を入力後に TAB キーを押して展開してください。
</p>

<p>Emacs の起動時に YASnippet を自動的にロードするようにするには、以下のコードをあなたの <code>~/.emacs</code> ファイルに書いてください：
</p>

<div class="highlight"><pre>(<span style="color: #19177C">add-to-list</span> <span style="color: #19177C">&#39;load-path</span>
              <span style="color: #BA2121">&quot;~/.emacs.d/plugins&quot;</span>)
(<span style="color: #008000">require</span> <span style="color: #19177C">&#39;yasnippet-bundle</span>)
</pre></div>

<p><a href="http://www.youtube.com/watch?v=76Ygeg9miao">この youtube のビデオ</a>では、ここに書いた簡単なインストール手順を実演しています。
</p>

<h3 id="normal-install">Normal 版のインストール</h3>

<p>YASnippet を通常の emacs パッケージとしてインストールするには、最新の <code>yasnippet-x.y.z.tar.bz2</code> をダウンロードして展開（解凍）してください。
<code>yasnippet-x.y.z</code> という名前のディレクトリができるはずなので、それを <code>~/.emacs.d/plugins</code> に置いてください。
そして、以下のコードをあなたの <code>.emacs</code> ファイルに追加してください：
</p>

<div class="highlight"><pre>(<span style="color: #19177C">add-to-list</span> <span style="color: #19177C">&#39;load-path</span>
              <span style="color: #BA2121">&quot;~/.emacs.d/plugins/yasnippet-x.y.z&quot;</span>)
(<span style="color: #008000">require</span> <span style="color: #19177C">&#39;yasnippet</span>) <span style="color: #408080; font-style: italic">;; not yasnippet-bundle</span>
(<span style="color: #19177C">yas/initialize</span>)
(<span style="color: #19177C">yas/load-directory</span> <span style="color: #BA2121">&quot;~/.emacs.d/plugins/yasnippet-x.y.z/snippets&quot;</span>)
</pre></div>

<p>カスタマイズのためのドキュメントをお読みください。もしくは、customization group をご利用ください。
</p>

<h2 id="how-to-use-yasnippet">YASnippet の使い方</h2>

<p>バージョン 0.6 から、YASnippet はより多くの機能を備えるようになっています。
スニペットを利用するだけなら、YASnippet のすべてを知る必要はありません。
しかし、それらの機能を知ることで、コーディングがもっと楽しくなるでしょう。
</p>

<p>この章は複数のドキュメントに分割されています：
</p>

<dl>
  <dt><a href="./snippet-organization.html">1. Organizing Snippets （スニペットを整理する）</a></dt>
  <dd>
    <p>ハードディスクの中にあるスニペットを体系的に整理する方法（あるいはまったく整理せずに <code>yasnippet-bundle.el</code> だけを使う方法）を説明しています。
    </p>
  </dd>
  <dt><a href="./snippet-expansion.html">2. Expanding Snippets （スニペットを展開する）</a></dt>
  <dd>
    <p>現在のカーソル位置で展開すべきスニペットを YASnippet がどのように選んでいるのか、ということを説明します。
    </p>
    <p>あるスニペットについて、特定のモードのとき、またはある条件のときにだけ展開されるようにしたいと思うかもしれません。
    また、<code>ido</code> を使ってプロンプトを表示させたいと思うかもしれません。
    </p>
  </dd>
  <dt><a href="./snippet-development.html">3. Writing Snippets （スニペットを書く）</a></dt>
  <dd>
    <p>スニペットを定義するための構文について説明します。この構文は TextMate のものにとてもよく似ています（しかし完全に同じというわけではありません）。
    TextMate のスニペットをコンバートする方法についての記述も含んでいます。
    </p>
  </dd>
  <dt><a href="./snippet-menu.html">4. The YASnippet menu （YASnippet メニュについて）</a></dt>
  <dd>
    <p>スニペットを探し出して、学んで、改造するために、YASnippet メニューをどのように使ったらよいかを説明します。
    </p>
  </dd>
</dl>

<h2 id="bugs-contribution-and-support">バグ報告、コミュニティへの貢献、サポート</h2>

<ul>
  <li><p>もしバグを見つけたら、<a href="http://code.google.com/p/yasnippet/issues/list">Issue List</a> に報告してください。</p></li>
  <li><p>YASnippet を利用する上での課題や新しいアイディアやスニペットをお持ちの場合は、<a href="http://groups.google.com/group/smart-snippet">discussion group</a> に投稿してください。</p></li>
</ul>

<p>YASnippet を使ってくださってありがとうございます！
</p>

</div><!-- class="contents" -->

</body></html>
